[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
RECEIVE
. Summary
receive(int <protocol>, str <name>);
. Description
The receive function is used to receive (download) one or more files
from another system. <protocol> is the letter used to select the ap-
propriate protocol from the actual download menu in Telix (e.g., 'X'
for Xmodem), as follows:
'A' ASCII
'K' Kermit
'M' Modem7
'S' SEAlink
'T' Telink
'X' Xmodem
'1' Xmodem-1k
'G' Xmodem-1k-g
'Y' Ymodem
'E' YmodEm-g
'Z' Zmodem
If an external protocol is defined, <protocol> may also be the key
used to select it. <name> is the name the file should take. For pro-
tocols which pass the name, such as SEAlink, Zmodem, Ymodem (batch),
and others, the name field should be an empty string, "". If a down-
load directory has been defined in the Configuration Menu, received
files will go there, unless the <name> string explicitly includes a
path to another drive/directory.
. Return Value
A value of -1 is returned if the transfer was aborted, except if the
Carrier (connection) was lost, in which case a value of -2 is re-
turned.
. Example
int result;
result = receive('X', "TEST.EXE");
if (result < 0)
prints("File transfer failed!");
See Also:
send
_down_dir
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson